home *** CD-ROM | disk | FTP | other *** search
/ Gigarom 1 / Gigarom Macintosh Archives (Quantum Leap)(CDRM1080320)(1993).iso / FILES / COP / A-M / IBM Uncompactors.cpt / IBM Uncompactors / ArcMac / ArcMac1.Doc < prev    next >
Text File  |  1988-02-08  |  32KB  |  1,144 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.       ArcMac
  10.  
  11.  
  12.  
  13.       Standard File Archiver for Macintosh Computers
  14.  
  15.  
  16.  
  17.  
  18.       Version 1.2
  19.       Released February 1988
  20.  
  21.  
  22.  
  23.  
  24.       Copyright 1988 by D.G. Gilbert
  25.       All rights reserved.
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.       dogStar Software
  34.  
  35.       PO Box 302
  36.       Bloomington
  37.       Indiana, 47402
  38.  
  39.       E-Mail: CompuServe 71450,1570
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.        
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                              TABLE  OF  CONTENTS
  74.  
  75.         1. ArcMac Features ...........................................2
  76.  
  77.         2. System Requirements........................................2
  78.  
  79.         3. Background.................................................3
  80.  
  81.         4. ArcMac Shareware Agreement.................................5
  82.  
  83.         5. Distribution Files.........................................6
  84.  
  85.         6. ArcMac Command Summary.....................................8
  86.  
  87.         7. Path Names.................................................9
  88.  
  89.         8. Disk Drive Identifiers....................................10
  90.  
  91.         9. MOS Command Subset........................................10
  92.               ?......................................................10
  93.               HELP  .................................................10
  94.               CD    pathName       ..................................10
  95.               CLS                  ..................................10
  96.               DIR  [pathName][/w]  ..................................11
  97.               EJECT drive:         ..................................11
  98.               EXIT                 ..................................11
  99.               GO    pathName [/w]  ..................................11
  100.               REM   remark         ..................................11
  101.               TYPE  fileName(s) [/l]   ..............................11
  102.               VER                  ..................................12
  103.               WHERE fileName(s)    ..................................12
  104.  
  105.        10. Redirection and Batch Processing..........................12
  106.  
  107.        11. MultiFinder & Backgrounding...............................13
  108.  
  109.        12. Finder Selections.........................................14
  110.  
  111.        13. MOS Devices...............................................15
  112.  
  113.        14. File Name Wild Cards......................................15
  114.  
  115.        15. Control Keys..............................................16
  116.  
  117.        16. Mouse Clicks..............................................16
  118.  
  119.  
  120.        17. Archiver Commands.........................................18
  121.               A, Add files to an archive.............................18
  122.               Modifiers for the Add commands.........................19
  123.               U, Updating archives...................................19
  124.               F, Freshening archives.................................20
  125.               M, Move files to archive...............................20
  126.               L, List archived files.................................20
  127.               V, Verbosely list files in an archive..................21
  128.               D, Delete files from archive...........................21
  129.  
  130.  
  131.                                      i
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.               E,X  Extract files from an archive.....................21
  141.               P, Print archived files................................22
  142.               T, Test archive integrity..............................23
  143.               C, Convert archive to new packing......................23
  144.  
  145.        18. Mouse Arc Dialog..........................................23
  146.  
  147.        19. Memory Requirements.......................................23
  148.  
  149.        20. ArcPop Usage..............................................24
  150.  
  151.        21. xArcMac Usage.............................................26
  152.  
  153.        22. ArcMac File Structure.....................................27
  154.  
  155.        23. Revision Information......................................28
  156.  
  157.        Martian Operating System for the Macintosh....................29
  158.  
  159.        ArcMac Fee Schedule ..........................................30
  160.  
  161.        ArcMac Invoice / Order Form ..................................31
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.                                      ii
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.       ArcMac Features 
  209.       ---------------
  210.  
  211.       *  Complete file archive / de-archive utility.
  212.  
  213.       *  Compatible with IBM and MS-DOS standard archives, makes data 
  214.          exchange a snap.
  215.  
  216.       *  Your choice of fast & flexible command line operation for 
  217.          experienced users, or point'n'click dialog for novices.
  218.  
  219.       *  Batch and background operations free you for other activities.
  220.  
  221.       *  Includes ArcPop, the compact, easy to use file de-archiver 
  222.          with the special feature of making self-extracting archives.
  223.  
  224.       *  Includes xArcMac, a utility for fully processing ArcMac 
  225.          archives on IBM/MS-DOS machines.
  226.  
  227.       *  Includes a useful subset of the Martian Operating System, a 
  228.          full MS-DOS like shell (Finder replacement) for the Macintosh.
  229.  
  230.  
  231.       System Requirements
  232.       -------------------
  233.       *  Current model Macintoshes with 128K or larger ROMS (Mac+, 
  234.          MacSE, MacII).
  235.  
  236.       *  Approximately 250 kilobytes of free memory for optimal 
  237.          operation; a minimum of about 180 kb.
  238.  
  239.       *  Validated on Apple System software version 5.0.  Operation of 
  240.          ArcMac on earlier system versions may differ significantly.
  241.  
  242.       *  Use with MultiFinder for background operation.
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  2
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.       Background
  276.       ----------
  277.  
  278.       ArcMac runs in a subset of the Martian Operating System, named 
  279.       for the reason that it is an obvious alien to the Macintosh 
  280.       graphic & mouse Finder system.  MOS (pronounced as "moss") is a 
  281.       keyboard and text based operating system that is patterned 
  282.       closely after Microsoft's MS-DOS (which in turn was patterned 
  283.       after CPM and numerous mainframe operating systems).  Though 
  284.       alien to the Macintosh, it is a familiar system to many computer 
  285.       users.
  286.  
  287.       The choice of MOS for running ArcMac is purposeful, not 
  288.       mischievious.  The reason for producing and releasing ArcMac is 
  289.       twofold, (1) to provide compatibility with the excellent MS-DOS 
  290.       standard file archivers, and (2) to provide an effective and 
  291.       efficient user - operating system interface for such file 
  292.       handling utilities.  
  293.  
  294.       The current Macintosh file archivers, Packit and Stuffit, are 
  295.       both "good Macintosh" programs, in that they follow guidelines 
  296.       that Apple has established for user interfaces.  But they are not 
  297.       efficient to use as file archivers, not because of a failing the 
  298.       in the algorithms used (Stuffit and ArcMac are based on the same 
  299.       ARC standard), but because the Macintosh Finder interface doesn't 
  300.       provide a proper platform.  Telling an application to operate on 
  301.       multiple files, in various subdirectories (folders), in a simple 
  302.       and quick way is not easy for Finder-based programs.  You 
  303.       generally have to wade through several dialogs, windows and 
  304.       whatnot, carefully pointing and clicking all the way.  There is 
  305.       also no way to do batch operations, that is, process a large 
  306.       number of commands written in a file.  Nor is there any easy way to 
  307.       redirect input or output.  
  308.  
  309.       With a command line operating system that recognizes subdirectory 
  310.       path specifications and file wild cards, you can specify a group 
  311.       of files to process in a few keystrokes.  Granted that command 
  312.       line operations are not as self evident as other forms...you 
  313.       require some learning time.  But after the learning period is 
  314.       over, it is much faster to use.  Thus, ArcMac seems designed only
  315.       for those who use it repeatedly and are willing to learn its 
  316.       operation.
  317.                       
  318.       All is not lost for the novice.  I've tried to incorporate the 
  319.       best of both worlds in ArcMac.  All of the major operations can 
  320.       be performed with an arc dialog by clicking buttons and summoning 
  321.       up the standard file dialogs.  Use of this arc dialog will also 
  322.       familiarize you with the command line keypresses needed.  You can 
  323.       also select files in the Finder, then shift-click to launch 
  324.       ArcMac from the same folder and operate on those files.  You can 
  325.       use the directory list command, dir, and then click on the names of 
  326.       files to process; all text on the MOS screen is clickable as 
  327.       though it were typed from the keyboard.
  328.  
  329.       Other benefits of this system include easy batch processing.  You 
  330.  
  331.  
  332.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  3
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.       can write a set of commands once, and, for example have ArcMac 
  343.       archive all of your working files in several folders, all as a 
  344.       MultiFinder background task (i.e., use it as a poor man's backup 
  345.       system).  Input and output are fully redirectable to other 
  346.       devices or files.  You could run ArcMac from another computer 
  347.       connected by serial ports, or have all output printed, or sent to 
  348.       a disk log file.   I've included a few useful operations from the 
  349.       full MOSystem that let you easily navigate a hard disk full of 
  350.       folders, list file directories, type out the contents of text 
  351.       files, or search for files.
  352.  
  353.  
  354.  
  355.  
  356.       My computing work has included extensive use of Apple //'s, IBM-
  357.       PCs, and Macintoshes.  I like a good machine, and good, efficient 
  358.       software tools.  Macs and PCs both have good points, and both 
  359.       have weaknesses.  Those of you who think that MS-DOS style 
  360.       operations are worthless might give ArcMac a real try, it may 
  361.       change your mind.  If not, you can always fire it up just to 
  362.       laugh at, and use ArcPop if you ever need to extract ArcMac'ed 
  363.       files.  
  364.  
  365.       ArcMac is dedicated to interspecies amicability, and freeing our 
  366.       data.  There is a lot of good information in both MS-DOS and Mac 
  367.       worlds; ArcMac is one bridge for the gap.
  368.  
  369.                                          Don Gilbert
  370.                                          Bloomington
  371.                                          January 1988
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  4
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.       ArcMac Shareware Agreement
  413.       --------------------------
  414.  
  415.       ArcMac is distributed as user supported shareware.  This means 
  416.       that, after you evaluate ArcMac and decide that it meets your 
  417.       needs, you are obliged to pay a fee ($25 basic, see tail section 
  418.       for additional schedules).  If you try it and do not like it, you 
  419.       are under no obligation to pay.  Either way, please feel free to 
  420.       pass on the full distribution archive to friends and electronic 
  421.       bulletin boards.  
  422.  
  423.       But if you continue using ArcMac and do not pay, you will be 
  424.       causing frustration for all sorts of people, including the 
  425.       author, who put in much time making this work, yourself and other 
  426.       users who will not be able to benefit from upgrades, and the
  427.       general community of shareware users and authors, as it becomes 
  428.       economically impossible for any but the rich or ill-advised to 
  429.       produce shareware.
  430.  
  431.       In return, dogStar will continue to upgrade ArcMac and 
  432.       insure its compatibility with current and future Macintosh 
  433.       software.  The next major release (version 2.0) will be a fast 
  434.       version, which we all want. 
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  5
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.       Distribution Files
  481.       ------------------
  482.  
  483.       ArcMac is distributed in a special format:  as a self-extracting 
  484.       archive application, under the name of ArcMac.ARC or ArcMac.BIN.  
  485.       If downloading this file from a bulletin board, use a transfer 
  486.       protocol that includes the MacBinary file setup.  
  487.               
  488.       When you get ArcMac on your Macintosh disk, it should appear with 
  489.       an application icon, or the ArcPop icon (the "A" button).  If 
  490.       transfered with MacBinary, it will have the name of ArcMac.Arc (a 
  491.       bit redundant, but it signifies that this file contains an 
  492.       archive of all the ArcMac files).  Just click on it and you will 
  493.       get the simple ArcPop dialog. Your default choice is to de-
  494.       archive the current contents, which you do by hitting the return 
  495.       key, or clicking the continue button.
  496.  
  497.               The contents of the ArcMac.Arc file are:
  498.  
  499.       ArcMac         -- the primary application
  500.  
  501.       ArcMac1.Doc    -- full documentation in "TEXT" form, readable by 
  502.           &          many applications, including the ArcMac type 
  503.       ArcMac2.Doc    command.  The file creator is TeachText, Apple's 
  504.                      text reader included with Apple System 5.0 and 
  505.                      some earlier systems.  After extracting, you can 
  506.                      either click on these files from Finder to launch 
  507.                      TeachText, or you can use the ArcMac command 
  508.                      "type" to get a printed list of this file, as per
  509.  
  510.                           type ArcMac*.doc > prn
  511.  
  512.  
  513.       xArcMac.exe    -- this is the MS-DOS executable program for fully 
  514.                      extracting and listing ArcMac archives on MS-DOS 
  515.                      machines.  You will need to transfer it to an MS-
  516.                      DOS machine to use. (You can transfer the entire 
  517.                      ArcMac.Arc, and use ARC or PKXARC to extract this
  518.                      file).
  519.  
  520.       ArcPop         -- this program is the application portion of 
  521.                      ArcMac.Arc.  To create the stand-alone ArcPop 
  522.                      application, without its ArcMac archive, choose 
  523.                      the "UnMake" button on the ArcPop dialog.
  524.               
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  6
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.               Other files in public distribution are:
  546.  
  547.       ArcPop.ARC     -- This is the ArcPop de-archive utility only, 
  548.                      with self-extracting documention.  ArcPop is 
  549.                      distributed freely, so than no one need pay to 
  550.                      access available ArcMac'ed data. If you don't care 
  551.                      for ArcMac, but want the capability of using 
  552.                      ArcMac'ed (or IBM/MS-DOS arc'ed) files, this is 
  553.                      the tool for you.
  554.  
  555.       MARCS.ARC      -- this archive contains Turbo Pascal source for 
  556.                      the xArcMac and the ArcPop programs, so that 
  557.                      others may incorporate the ArcMac file structure 
  558.                      and protocol in archivers.  
  559.  
  560.  
  561.       Current versions of these files can be obtained from
  562.       Bloomington's PC-LINK bulletin board, phone 812-335-7272 
  563.       (1200..9600 Baud, 24hr).
  564.  
  565.  
  566.       The CompuServe MACPRO Maug Sig and BORPRO Borland Sig will 
  567.       generally have the most recent updates.
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  7
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.       ArcMac Command Summary
  615.       ----------------------
  616.  
  617.       ?       - lists all available commands.
  618.  
  619.       ARC  command[modifiers]  archive  [filename ...]
  620.               - the archiving command line.
  621.         
  622.       CHDIR pathName       - change directory
  623.  
  624.       CD    pathName       - change directory
  625.  
  626.       CLS                  - clear screen
  627.  
  628.       DIR  [pathName][/w]  - display current or named directory, /w = wide
  629.  
  630.       EJECT drive:         - eject disk from disk drive
  631.  
  632.  
  633.       EXIT                 - quit MOS to Finder
  634.  
  635.       GO    pathName [/w]  - change directory with display
  636.  
  637.       HELP  [command]      - info about all or the named command.
  638.  
  639.       REM   remark         - a comment line in a batch command file.
  640.  
  641.       TYPE  fileName(s)    - display the contents of file(s)
  642.  
  643.       VER                  - display MOS version
  644.  
  645.       WHERE fileName(s)    - search dir & subdirs for named file(s)
  646.  
  647.        > device or fileName - redirect output
  648.  
  649.        < device or fileName - redirect input
  650.  
  651.  
  652.       MOS devices:                    con  = console 
  653.         prn  = printer(port .B)       trm  = terminal(port .A)
  654.         com1 = serial port .A         com2 = serial port .B 
  655.  
  656.       Name wild cards: ? = match 1 letter, * = match many letters
  657.  
  658.       Control keys   : ^C = user break, ^S = stop list
  659.  
  660.       Mouse clicks   : on word = type it, on ) = carriage return
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  8
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.       Path Names
  682.       ----------
  683.  
  684.       All MOS command line prompts are preceded with a path name 
  685.       specifier as:
  686.  
  687.         ?© HARD:MyFolder: > 
  688.  
  689.       The current folder is "HARD:MyFolder" and all commands that don't 
  690.       include a path specification will operation on files in this 
  691.       folder.  The preceding "?©" (question mark, circle-c) is a quick 
  692.       help command that when mouse-clicked, will provide a list of all 
  693.       available commands.  
  694.  
  695.       Full Macintosh operating system path names are specified as the 
  696.       names of all folders from the root folder into the desired 
  697.       folder, with names separated by colons, as for instance:
  698.  
  699.             HARD:TurboF:MartianF:ArcMacF: 
  700.  
  701.       for a folder that is nested 3 levels into the HARD volume.  MOS 
  702.       allows you to use partial pathnames and does it's best to find 
  703.       them.  All folders that are open in Finder when you start 
  704.       MOS/ArcMac are made working directories, so that you can specify 
  705.       them with their one name.  
  706.  
  707.       You can use the standard MS-DOS path specifiers instead of the
  708.       Macintosh path colon, e.g.
  709.          
  710.               H:\TurboF\MartianF\ArcMacF\
  711.  
  712.       is equivalent to the above full path.
  713.  
  714.       If your current directory is ArcMacF, then partial path names 
  715.       include 
  716.  
  717.               ::BobsF
  718.               ..BobsF
  719.               ..\BobsF
  720.  
  721.       which all refer to a folder "BobsF" that is a sibling of the 
  722.       current ArcMacF folder (that is, it is found in the directory of 
  723.       the next higher level, "MartianF").
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  9
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.       Disk Drive Identifiers
  748.       ----------------------
  749.  
  750.       The Macintosh operating system uses names for each disk, to
  751.       identify paths.  Mac programmers also can access the drives using 
  752.       a reference number starting from 1.  To let you specify a disk 
  753.       drive independent of the name of the disk in it, MOS supports the 
  754.       MS-DOS style drive naming conventions "A:" to "Z:".  Mac number 
  755.       equivalents are "1:" to "9:".  The first Sony 3.5" drive is 
  756.       always "A:" or "1:", the second Sony is "B:" or "2:".  The first 
  757.       SCSI hard disk is "H:" or "8:". 
  758.  
  759.        Drive Name    Alternate Name    Hardware Device
  760.               A:          1:           First .Sony (internal) disk
  761.               B:          2:           Second .Sony (external) disk
  762.               H:          8:           First SCSI Hard drive
  763.  
  764.  
  765.  
  766.       MOS Command Subset
  767.       ------------------
  768.  
  769.       ?
  770.               Type a question mark to get a list of all available 
  771.       commands.
  772.         
  773.  
  774.       HELP            
  775.       HELP  command           
  776.  
  777.               Entering this command provides a summary of all commands. 
  778.       Add the name of a specific command to get information about that 
  779.       command only.
  780.  
  781.  
  782.       CD    pathName        
  783.       CHDIR pathName        
  784.  
  785.               These commands change the active folder (directory) to 
  786.       the given path name. A partial or full pathname can be specified,
  787.       as well as volume (disk drive) identifiers. 
  788.  
  789.       To change the default disk drive, you can use the CD command or 
  790.       just the drive letter identifier, as per MS-DOS operations.  Both 
  791.       of these commands change the active drive from drive H: (hard 
  792.       disk) to the first Sony drive:
  793.  
  794.               ?© HARD: >cd a: 
  795.               ?© HARD: >a:       
  796.  
  797.  
  798.       CLS                  
  799.               
  800.               Clear the display screen.
  801.  
  802.  
  803.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  10
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.       DIR  [pathName][/w]  
  816.  
  817.               List the files in the specified directory.  If no
  818.       pathname is given, the current folder contents are listed.  The 
  819.       default listing show the name, type, creator, data fork size 
  820.       (Size0), resource fork size (Size1), date and time of last 
  821.       modification.  The /W option switch produces a wide listing of 
  822.       file names only.    
  823.  
  824.  
  825.       EJECT drive:         
  826.  
  827.               Eject a flippy disk from the specified drive.  Has no 
  828.       effect on hard disk drives. 
  829.  
  830.               Eject A:    -- eject disk in internal or 1st flippy drive
  831.               Eject B:    -- eject disk in external or 2nd flippy drive
  832.  
  833.  
  834.       EXIT
  835.  
  836.  
  837.               Quit MOS.  There are several other ways to quit, 
  838.       including click on the MOS window close box, or select Quit from 
  839.       the File menu, or type the Break key (control-C or enter) at the 
  840.       command line.
  841.  
  842.  
  843.       GO    pathName [/w]  
  844.               
  845.               Go to the named folder and list its contents.  This 
  846.       command is equivalent to
  847.  
  848.                 CD pathName
  849.                 DIR  [/w]
  850.  
  851.       REM  remark
  852.  
  853.            This is a do-nothing command useful for adding comments to 
  854.       batch command files (see examples below).  Any text on a line 
  855.       starting with REM is ignored (vers. 1.2 addition).
  856.  
  857.  
  858.       TYPE  fileName(s) [/l]   
  859.               
  860.               This command lists (types out) the contents of all 
  861.       matching files.  Only data fork contents are listed.  Any file 
  862.       can be typed out, but this command is useful mainly for files of 
  863.       type "TEXT".  By default, a title line naming the file and its 
  864.       date is typed first.  The /L option switch disables this header 
  865.       line.  In contrast to the MS-DOS standard type, the filename may 
  866.       be a list of file names, including wild cards.  Each matching 
  867.       file will be typed in turn, and a form feed character is sent to 
  868.       the output device after each file.  This makes type a simple way 
  869.  
  870.  
  871.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  11
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.       to print multiple text files, as per
  882.  
  883.               TYPE  *.txt > prn
  884.  
  885.  
  886.       VER                             
  887.                This command displays copyright and the current MOS 
  888.       version.
  889.  
  890.  
  891.       WHERE fileName(s)    
  892.  
  893.               This operation searches folders and sub-folders for the 
  894.       specified filename, which usually includes wild cards. The full 
  895.       path name of each matching file is listed. For instance,
  896.               
  897.               Where  *.arc   -- search the current folder and all sub-
  898.       folders for files ending in the string ".arc"
  899.  
  900.               Where H:bob*    -- searches the hard disk drive H: and 
  901.       all of its folders for files beginning with the name "bob"
  902.  
  903.               Where  H:JoesF:bob*  -- searches only the folder JoesF
  904.       and its children folders for "bob"
  905.        
  906.  
  907.  
  908.       Redirection and Batch Processing
  909.       --------------------------------
  910.  
  911.        > device or fileName - redirect output
  912.        < device or fileName - redirect input
  913.  
  914.       Use the special piping characters ">" and "<" to redirect output 
  915.       or input to a command, or to redirect all MOS output or input.  
  916.       When used in conjunction with a command line, the output or input 
  917.       from that one operation is redirected.  For instance,  
  918.  
  919.               ARC  l  myArc  > myArc.list
  920.  
  921.       will cause the archive listing to be written to a file named 
  922.       "myArc.list".  
  923.  
  924.       When used as the first command on a command line, all subsequent 
  925.       input or output of commands is redirected.  For example, if you 
  926.       create a text file named "DoArc.Bat" with the following contents
  927.          
  928.               rem             let's make the archive folder active
  929.               cd h:archives
  930.               rem             update my working folder archives
  931.               arc u docs  h:docs:*.*
  932.               arc u data  h:data:*.*
  933.               arc u pics  h:pics:*.*
  934.               rem             and now we're done
  935.               exit
  936.  
  937.  
  938.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  12
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.       This is a set of ArcMac commands to update the archives of a 
  950.       series of folders.  Then you can operate ArcMac in a batch mode 
  951.       by redirecting its command input to this file, as per
  952.  
  953.               < DoArc.bat
  954.  
  955.       Individual command line output can be redirected within a batch 
  956.       file.  For instance, to get a printed listing of the updated 
  957.       archives, you could add these commands to DoArc.Bat
  958.  
  959.               arc v docs  > prn
  960.               arc v data  > prn
  961.               arc v pics  > prn
  962.  
  963.       ArcMac version 1.1 can be operated from a start-up batch file 
  964.       entirely, making it compatible with other shell programs for 
  965.       independent operations.  If you launch ArcMac with one accessory 
  966.       file, and that file contains the ".BAT" name extension, then 
  967.       ArcMac will take its command line input from this file.  When 
  968.       launching from Finder, you can select both the ArcMac application 
  969.       and your batch file, for instance "DoArc.bat", then double-click 
  970.       to launch.  As a further simplification, change the "file 
  971.       creator" of the batch file to "arc*", which is ArcMac's creator 
  972.       name, then you can double click on the batch file only, and 
  973.       Finder will launch ArcMac from whereever it is hidden among your 
  974.       folders.   For command line shells like MOS or the MPW shell, you 
  975.       can use a command such as 
  976.  
  977.                 > ArcMac  DoArc.Bat
  978.  
  979.  
  980.  
  981.       MultiFinder & Backgrounding
  982.       ---------------------------
  983.  
  984.       MOS is MultiFinder compatible and will operate as a background 
  985.       application.  The archiving operations in particular lend 
  986.       themselves to backgrounding, since you can make a big list of 
  987.       folders to archive as a batch file of commands, then redirect 
  988.       ArcMac command input to this batch file.  You need to mouse click 
  989.       on an icon outside of ArcMac to put it to sleep, and wait up to 
  990.       10 seconds for ArcMac to get sleepy.
  991.  
  992.       The 10 second wait for backgrounding is needed to insure fast 
  993.       processing when ArcMac is in the foreground.  When in the 
  994.       background, archiving takes at least 10 times as long, but this 
  995.       is no hassle, since you and your Macintosh are free to pursue 
  996.       other activities.
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  13
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.       Finder Selections
  1015.       -----------------
  1016.  
  1017.       When launching ArcMac from Finder, two methods of selecting files 
  1018.       in Finder work.  If you want to work with an existing ArcMac 
  1019.       archive, you can double-click on it and Finder will launch 
  1020.       ArcMac.  The MOS display lists the name of your archive as a 
  1021.       selected file.  You can give an arc command or use the Mouse 
  1022.       dialog with this default archive:
  1023.  
  1024.               Selected files: My.ARC
  1025.               ?© HARD:jake:> arc l 
  1026.                       -- after you type the "arc l" command, the 
  1027.       selected archive My.ARC is listed.
  1028.  
  1029.       The other method of file selection from Finder is to move the 
  1030.       ArcMac application to a folder containing files that you want to 
  1031.       archive.  Select all the files to operate on, and also select 
  1032.       ArcMac, using a lasso with the mouse or using shift-clicks.  Then 
  1033.       double click ArcMac or one of the selected files.  Your startup 
  1034.       display will look something like:
  1035.  
  1036.               Selected files: Data.1  Data.2  Data.3  Data.4
  1037.               ?© HARD:jake:>  arc a mydata 
  1038.                       -- after you type the "arc a mydata" command, the 
  1039.       selected files are added to archive "mydata.arc".  Alternately, 
  1040.       you can use the Mouse menu to produce the arc add command to add 
  1041.       the selected files.
  1042.  
  1043.       Both methods of file selection work only for the first MOS 
  1044.       command.  After that, the Finder selections are forgotten.  See 
  1045.       the previous section for launching with a ".BAT" batch file.
  1046.  
  1047.       ArcMac has no control about how Finder/Multifinder passes file 
  1048.       selections to it.  The following cases exist for System 5.0 
  1049.       software (differs in pre-MultiFinder systems):
  1050.  
  1051.           a) Single (non-multi) mode does not permit any file 
  1052.           selections.  This is same for any application, including 
  1053.           Packit & Stuffit. 
  1054.  
  1055.           b) Multi-mode, 1 application + any group of documents in a 
  1056.           single folder: You can select doc files and ArcMac, and then 
  1057.           launch ArcMac.  In this case, all of the files will be 
  1058.           selected to operate on.
  1059.  
  1060.           c) Multi-mode, 2 or more applications selected:  Multifinder 
  1061.           will launch all applications independently, and will launch 
  1062.           the creator applications of selected documents.  In other 
  1063.           words, you can not select applications to archive from Finder.
  1064.  
  1065.       This is part of the reason that ArcMac has an MS-DOS style 
  1066.       interface: selection of files of disparate origins and types to 
  1067.       operate on is simple, rather than impossible.
  1068.  
  1069.  
  1070.  
  1071.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  14
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.       MOS Devices
  1082.       -----------
  1083.  
  1084.       When redirecting input or output, you can specify a disk file 
  1085.       name or one of the following hardware devices.  
  1086.  
  1087.       CON  = console
  1088.  
  1089.               The console is the display window and keyboard
  1090.        
  1091.       PRN  = printer (port .B)  
  1092.  
  1093.               This is the printer serial port. No Macintosh printer 
  1094.       device driver is used to filter the output of this device, so you 
  1095.       printer needs to be able to print standard ASCII characters (as 
  1096.       does Apple's Imagewriter and all other dot matrix or daisy wheel 
  1097.       printers).  The complete MOS program contains an LPT device that 
  1098.       operates through your standard Macintosh printer driver.  The 
  1099.       port is fixed in ArcMac but can be switched in MOS.
  1100.  
  1101.  
  1102.       TRM  = terminal(port .A)
  1103.  
  1104.               This is a terminal (input and output) device with echo 
  1105.       to the MOS display.  It is not a full communications package, and 
  1106.       uses no special transfer protocols, but you can redirect MOS 
  1107.       input and output to another computer running some terminal 
  1108.       software. Port is fixed to .A (the modem port) in ArcMac but 
  1109.       switchable in MOS.
  1110.  
  1111.  
  1112.       COM1 = serial port .A   
  1113.  
  1114.               This is always serial port .A (modem) and no processing 
  1115.       is done on input or output.
  1116.                
  1117.       COM2 = serial port .B 
  1118.  
  1119.               This is always serial port .B (printer) and no 
  1120.       processing is done on input or output.
  1121.  
  1122.  
  1123.       File Name Wild Cards
  1124.       --------------------
  1125.  
  1126.       The Macintosh operating system is very liberal in its file naming 
  1127.       conventions.  Just about any letter exclusive of the path 
  1128.       separator ":" can be included in a name.  This liberality is 
  1129.       feasible because in most Macintosh programs, file names are rarely 
  1130.       used to identify which files to operate on (or only in the visual 
  1131.       sense, of clicking on a name in a list).  
  1132.  
  1133.       In text based systems, like MOS, file names are the key to 
  1134.       identifying files, and there are certain conventions that allow 
  1135.  
  1136.  
  1137.        ArcMac  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  ~~  15
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.